Vibe Coding 的新手體驗 - Antigravity
TLDR
- Antigravity 是基於 Code OSS 建構的開發工具，適合習慣 VS Code 的開發者。
- 額度與網頁版 Gemini 分開計算，但不同模型消耗額度的權重不同。
- 建議設定
Request Review權限，避免 Agent 自動執行高風險指令。 - 透過
GEMINI.md檔案可定義全域或專案級的背景資訊與行為規範。 - 務必檢查 Agent 產出的程式碼與腳本，避免編碼錯誤、殘餘檔案或技術債。
- 善用 Agent 處理重複性高的檔案遷移或批次作業，但核心邏輯與 Git 操作建議由人工把關。
Antigravity 核心機制與設定
Antigravity 是基於 Code OSS 建構的開發環境，操作邏輯與 VS Code 高度相似。
額度管理與監控
Antigravity 的額度池與網頁版 Gemini 是分開計算的。透過安裝 Antigravity Cockpit 擴充套件，開發者可以在右下角即時監控各模型的剩餘額度。
WARNING
雖然同一個額度群組（Quota Group）內包含多個模型，但這不代表同組內不同模型消耗額度的權重（Weight）相同。
權限與行為控制
為了確保開發安全，建議在 Settings => Open Antigravity User Settings 中根據專案性質調整權限：
- Review Policy：建議設定為
Request Review，確保 AI 在執行計畫前需經由人類確認。 - Browser Tools：若涉及金流或外部介接，JavaScript 執行權限應設為
Request Review；純靜態網站則可設為Always Proceed。 - Conversation Mode：建議使用
Planning模式，讓 Agent 先產生執行計畫，避免直接執行導致的不可控風險。
Agent 記憶體設定 (GEMINI.md)
透過在專案目錄建立 GEMINI.md，可以強制 Agent 參考特定的背景資訊與規範。其繼承規則如下：
- 更具體的檔案優先：子目錄的檔案會覆寫或補充上層目錄的內容。
- 由近到遠載入：Agent 會從當前工作目錄逐層向上查找，直到專案根目錄。
TIP
此功能常用於鎖定 Commit 規範，確保 Agent 產出的 Commit Message 符合專案標準。
實際應用場景與技巧
檔案遷移與自動化
Antigravity 擅長處理「不難但繁瑣」的任務，例如：
- 圖片遷移：透過指令要求 Agent 檢查 Markdown 連結、下載圖片至指定資料夾並批次替換連結。
- 框架轉換：利用 Agent 讀取異動歷程與標題，自動為大量 Markdown 檔案生成符合 VitePress 或 Jekyll 規範的 Frontmatter。
- API 批次作業：編寫腳本呼叫外部 API（如 HackMD API）進行大量內容更新。
瀏覽器自動化測試
透過 Antigravity Browser Control 擴充套件，Agent 可讀取 DOM 進行 End-to-End 測試。
- 什麼情況下會遇到這個問題：當需要進行跨頁面或樣式檢查時，Agent 可能會因無法精確判斷 RWD 樣式而產生誤判。
- 注意：此功能會額外呼叫 Gemini Flash 模型，會產生額外的額度消耗。
踩雷紀錄與技術建議
在使用 Vibe Coding 模式時，開發者應特別注意以下潛在風險：
1. Git 快照衝突
- 什麼情況下會遇到這個問題：在 Agent 執行任務期間，若開發者手動透過 Git 修改檔案，可能導致 Agent 使用舊版快照覆蓋變更。
- 建議：執行 AI 任務時避免同時進行 Git 操作。
2. 編碼與腳本偏好問題
- 什麼情況下會遇到這個問題：Agent 偏好使用 Python 或 PowerShell 處理批次任務，若未指定編碼方式，容易導致中文內容變為亂碼。
- 建議：在指令中明確要求使用編碼安全（如 UTF-8）的方式處理檔案。
3. 殘餘檔案與技術債
- 什麼情況下會遇到這個問題：Agent 執行任務時產生的臨時腳本或文字檔若未清理，容易被誤 Commit 進版本庫。
- 建議：在
.gitignore中設定忽略清單，並在開發完成後手動 Review 程式碼，避免 AI 產出缺乏維護性的「一次性程式碼」。
4. 幻覺與語意理解限制
- 什麼情況下會遇到這個問題：當要求 Agent 進行批次內容轉換（如大陸用語轉台灣用語）時，若未讓其先閱讀全文，可能導致語意誤判。
- 建議：避免使用
Fast模式處理複雜邏輯，應要求 Agent 先讀取上下文再進行判斷。
異動歷程
- 2026-01-07 初版文件建立。
- 2026-01-08 補充 GEMINI.md 的作用範圍、繼承關係說明及測試方法。
- 2026-03-13 補充 Google 於 2026-03-12 調整 Antigravity 配額機制的相關說明。